home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / DOCZ16.ZIP;1 / DOCZ.LIF / UPDATE.DOC < prev    next >
Encoding:
Text File  |  1994-04-24  |  6.1 KB  |  166 lines
  1. ---------------------------- Update.doc ------------------------------
  2.  
  3. This file contains information concerning DOCZ 1.6 that didn't make it
  4. into the User Manual.
  5.  
  6. ----------------------------------------------------------------------
  7.  
  8. UNIX platform only:
  9.  
  10. Library and module names may contain punctuation.  The MSDOS platform
  11. still restricts the use of punctuation in library and module names,
  12. since the names may be used in file specifications.
  13.  
  14. DOC ver. 33296
  15.  
  16. ----------------------------------------------------------------------
  17.  
  18. All platforms:
  19.  
  20. A new parameter has been added to the DOCZ Documentation Header that
  21. allows the catagorization of modules by logical "levels."  This can
  22. be especially useful in subroutine libraries designed in logical
  23. layers, and when specific layers are appropriate for application
  24. development.  The .LAYER parameter is a singly-specified optional
  25. parameter that may have a single decimal digit between 0 and 9
  26. following the parameter.  The DOC program will take the following
  27. options to make use of the new parameter:
  28.  
  29.      DOC <library name> [/l=n1,n2,n3...] [z_opt]
  30.         -> entire library
  31.  
  32.     DOC <library name> <module> [module]...[module] [/l=n1,n2,n3...] [z_opt]
  33.         -> module(s) docs
  34.  
  35.     DOC <library name> </m[=date]> [/s] [/l=n1,n2,n3...] [z_opt]
  36.         -> modified since
  37.  
  38.     DOC <library name> </r[=date]> [/s] [/l=n1,n2,n3...] [z_opt]
  39.         -> revised since
  40.  
  41.     DOC <library name> </i[=date]> [/s] [/l=n1,n2,n3...] [z_opt]
  42.         -> introduced since
  43.  
  44.     DOC <library name> </f[=date]> [/s] [/l=n1,n2,n3...] [z_opt]
  45.         -> fixed since
  46.  
  47. All DOC options which produce module documentation can be modified
  48. with the /l option (case is ignored:  /l is the same as /L), where
  49.  
  50.     /l=n1,n2,n3...
  51.  
  52. is the option specifier and 'n1', 'n2', and so forth are one or more
  53. "levels" to document.  If no level is specified (i.e. the /l option
  54. is not specified) then all levels will be documented.  The output
  55. documentation will include the module level, if included in the
  56. Documentation Header.
  57.  
  58. DOC ver. 33325
  59.  
  60. The /s option has been added to produce a summary for each of the
  61. individual DOC reports:  Modifed, Revised, Introduced and Fixed.  The
  62. /s on the command line with the fix, introduction, revision, and/or
  63. modification notice options produces a summary of the modules in the
  64. notice with output going to a file with the name:
  65.  
  66.     <library_name>.MOD      modification notice
  67.     <library_name>.REV      revision notice
  68.     <library_name>.FIX      fix notice
  69.     <library_name>.INT      introduction notice
  70.  
  71. DOC ver. 33213
  72. ----------------------------------------------------------------------
  73.  
  74. VMS platform:
  75.  
  76. All VMS development and support has been dropped completely.  Refunds
  77. are available for any licensed and current version of VMS DOCZ. 
  78. Discounts are available for migration to the UNIX or MSDOS platforms
  79. of DOCZ.  We apologize to VMS advocates, but offering a VMS platform
  80. of DOCZ proved to be entirely cost-ineffective, and Digital Equipment
  81. Corp. is not interested in cooperative VMS product support of DOCZ.
  82.  
  83. ----------------------------------------------------------------------
  84.  
  85. The telephone area code in which Software Toolz is located will
  86. change from 404 to 706 on 3 May 1992.  Our FAX machine is connected
  87. to a call director that will automatically route your incoming faxes
  88. if your fax machine issues CNG tones.  If your fax machine does not
  89. issue CNG tones, dial 11 repititively after hearing the first
  90. ring-back.  Toll-free voice-mail (US & CAN) will be discontinued on 1
  91. April 1992.
  92.  
  93. Software Toolz, Inc.
  94. 8030 Pooles Mill Dr.
  95. Ball Ground, GA 30107-9610
  96. Phone:  +1 706 889 8264
  97. FAX:  + 1 706 887 5960 (add ",,,,11" if no CNG tones)
  98. Internet: software%toolz.uucp@mathcs.emory.edu
  99.  
  100. ----------------------------------------------------------------------
  101.  
  102. All platforms:
  103.  
  104. The CALCDATE utility now includes an option to calculate the version
  105. number used in Software Toolz programs (including all DOCZ programs).
  106. CALCDATE also supports the variable date format (see the DOCZ User
  107. Manual) with the date format specified on the command line.  If the
  108. /f option is not specified, the system-wide default date format is
  109. used.
  110.  
  111.     CALCDATE [date] [/o=output file] [+/- days] [/v] [/f=<date format>]
  112.  
  113. The new /v option specifies that the date should be output as a value
  114. (Julian date) instead of a date string.  The version number displayed
  115. by Software Toolz programs may then be compared to an actual date. 
  116.  
  117. CALCDATE ver. 33584
  118.  
  119. ----------------------------------------------------------------------
  120.  
  121. All platforms:
  122.  
  123. The DOCXL /o option has been modified to allow all libraries to be
  124. referenced with one call to DOCXL.  Previously, DOCXL required
  125. a library name when using the /o option, and only one library at
  126. at time could be used.
  127.  
  128. DOCXL ver. 33699
  129.  
  130. ----------------------------------------------------------------------
  131.  
  132. All platforms:
  133.  
  134. The DOCXL /o option has been modified to allow the introduction
  135. date to be displayed with the I option.  This was an omission
  136. in earlier versions.
  137.  
  138. DOCXL ver. 33733
  139.  
  140. ----------------------------------------------------------------------
  141.  
  142. MSDOS platform:
  143.  
  144. For those who wish to run the DOCZ programs under MS-Windows,
  145. PIFs are now included.  If you elect to install the PIFs in
  146. the Installation Program, also specify the Windows drive and
  147. directory into which they will be installed.
  148.  
  149. ----------------------------------------------------------------------
  150.  
  151. The use of an absolute path in the Documentation Index File
  152. will defeat the substition of any path rules specified with
  153. a 'U' record in the Configuration File.  This is not explicitely
  154. explained in the DOCZ User Manual.
  155.  
  156. ----------------------------------------------------------------------
  157.  
  158. Any licensed DOCZ users who wish to receive notice of software
  159. updates via e-mail, and have accounts on either Internet or
  160. Compuserve, can register their e-mail addresses with Software Toolz.
  161. (No "junk mail" will be sent.)  We are also considering the
  162. possibility of offering a bulletin board for users.  If you are in
  163. favor of this idea, please let us know.
  164.  
  165. ----------------------------------------------------------------------
  166.